<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<link type="text/css" rel="stylesheet" href="office11.css"/>
<link type="text/css" rel="stylesheet" href="style.css"/>
</head>
<body>
	<h1>
		<img src="Search.ico" width="16" height="16" alt="Search"/>
		Search
	</h1>
<p>The Search window allows searching for files inside the shares of on-line users. You can search for
one or more keywords and optionally use filters as described below. When your search query is ready, press the Search button to send out the search request to the hub(s) you are connected to; these hubs will then forward the search request to all of their connected users.</p>
<p>When a client matches a search request, it sends the results back to the requester. These results then show up in the search results list of the Search window.</p>
<p>You can open several independent Search windows and define different search arguments in each, thus allowing you to process multiple searches simultaneously. Be careful though, it sometimes happens that search results show up in the wrong window (this is a deficiency of the NMDC protocol, and should never happen with ADC hubs).</p>
<p>Note that <b>search requests are sent out only once, when the Search button is pressed</b>. After that - until that button is pressed again - the sole purpose of the Search window is to show results received by DC++ that: either match the search query (NMDC); or match the search ID (ADC).<br/>
(This means that users who have logged in <i>after</i> you pressed the Search button won't send you any search result unless
you repeat the search.)</p>
<p>You may not start or repeat searches as fast as you like. There is a minimum interval of a few seconds between two searches
defined in DC++. You will get a countdown message in the Status bar if you try to search sooner than allowed 
and will be able to repeat the search only when the client is ready to search again. Besides, some hubs also limit searches by checking for forbidden keywords or by blocking repeated similar searches sent in a too small amount of time. Some hubs have
predefined minimum search intervals for all searches or some even totally block searches if you are in 
<a href="settings_connection.html#connection">passive mode</a>.</p>
<p>Search hits with TTH are always matched to the Download queue and new sources are automatically added to the queue items
unless they were removed or marked as "bad" sources before. The filelists of all newly discovered sources will be automatically
matched for possible other queued files if the <a href="settings_queue.html#automatchqueue">Automatically match queue for search hits</a>
setting is enabled. Activating that option can generate lots of filelist traffic when large amount of new sources are found for queued files.</p>

<p>If you often get too few search results or no results at all, refer to the <a href="faq_nosearch.html">Search troubleshooting FAQ</a>.</p>

<h2>Search options (left)</h2>
<dl style="margin-left: 40px;">
  <dt>Search for</dt>
  <dd cshelp="IDH_SEARCH_SEARCH_FOR">This is the set of search strings to search for. Words beginning with "-" will be filtered away.</dd>
  <dt>Purge</dt>
  <dd cshelp="IDH_SEARCH_PURGE">Clear the contents of the <a href="settings_history.html#searchhistory">search history</a>.</dd>
  <dt>Search</dt>
  <dd cshelp="IDH_SEARCH_SEARCH">Start searching for the set of search strings defined above. Note; you may not start too many searches in a small amount of time.</dd>
  <dt>Size</dt>
  <dd cshelp="IDH_SEARCH_SIZE">Filter away files depending on their file size.</dd>
  <dt>File type</dt>
  <dd cshelp="IDH_SEARCH_TYPE">Filter away files depending on their file type (extension).
  Not all possible extensions are included in some file type groups. If you search for newer or obscure file types, then it is recommended to use the <i>Any</i> option and include
  	the file extension in the search string instead. Options other than <i>Any</i>, <i>Directory</i> &amp; <i>TTH</i> are ignored for searches on ADC hubs.</dd>
  <dt>Only users with free slots</dt>
  <dd cshelp="IDH_SEARCH_SLOTS">Filter away files depending on the user's free slots.</dd>
  <dt>Hide files already in share</dt>
  <dd cshelp="IDH_SEARCH_SHARE">Filter away files that are already in share.</dd>
  <dt>Merge results for the same file</dt>
  <dd cshelp="IDH_SEARCH_MERGE">
  If checked (default), when multiple search results are received for the same file (same TTH
  root), these search results will be merged into 1 entry.<br/>
  If unchecked, each search result will have its own entry in the search results list.
  </dd>
  <dt>Hubs</dt>
  <dd cshelp="IDH_SEARCH_HUBS">Search only selected hubs.</dd>
</dl>
<h2>Results list (right)</h2>
<h3>Columns</h3>
<dl style="margin-left: 40px;">
  <dt>File</dt>
  <dd>The file name.</dd>
  <dt>User</dt>
  <dd>The user's nick name.</dd>
  <dt>Type</dt>
  <dd>The file's extension (file type).</dd>
  <dt>Size</dt>
  <dd>The file's size.</dd>
  <dt>Slots</dt>
  <dd>x/y: x slots available of a total y.</dd>
  <dt>Path</dt>
  <dd>The path in the user's file list where the file is stored.</dd>
  <dt>Connection</dt>
  <dd>The user's possible <a href="settings_general.html#linespeed">line speed in upload</a>.</dd>
  <dt>Hub</dt>
  <dd>In which hub the user is in.</dd>
  <dt>Exact size</dt>
  <dd>The exact size of the file.</dd>
  <dt>IP</dt>
  <dd>The user's IP.</dd>
  <dt>TTH root</dt>
  <dd>The TTH root for the file.</dd>
  <dt>CID</dt>
  <dd>The unique ID that DC++ use to identify other users.</dd>
</dl>

<h3>Context menu commands</h3>
<!--#include virtual="commands_file_download.inc" --> 
<dl style="margin-left: 40px;">
  <dt>Download whole directory</dt>
  <dd>If one or more files selected from the same folder it will add the whole folder
  	  to the Download Queue.</dd>	  
  <dt>Download whole directory to...</dt>
  <dd>Combines the function of <i>Download to...</i> and <i>Download whole directory</i> 
  	  commands</dd>	  
  <dt>View as text</dt>
  <dd><p>It downloads the selected file to the temporary folder of the operating system and opens
  	  its contents in a text viewer window. The file will be deleted right after its contents shown.</p>
  	  <!--#include virtual="commands_viewastext.inc" --> 
  </dd>
</dl>
<!--#include virtual="commands_file_general.inc" --> 
<!--#include virtual="commands_user_general.inc" --> 
<!--#include virtual="commands_user_favorites.inc" --> 
<!--#include virtual="commands_listview.inc" --> 

<h2>Status bar</h2>
<dl style="margin-left: 40px;">
  <dt>Unnamed checkbox</dt>
  <dd>Toggle the displayment of the search options.</dd>
  <dt># items</dt>
  <dd>The amount of items that are displayed in the window.</dd>
  <dt># filtered</dt>
  <dd>The amount of files that have been filtered away from the view.</dd>
</dl>
</body>
</html>
